PM I-Cat is a 32-bit multi-threaded OS/2 Presentation Manager program for
viewing and managing your image files.
PM I-Cat can display a number of different types of image files from one or
more directories that you specify. The images are displayed in miniature format
(sometimes called a 'thumbnail' view) and are arranged in a grid, much like
slides on a light table. The completed slide group may be saved to a file or
exported in one of several image file formats.
Double-clicking on any displayed slide may invoke a built-in image file
browser, an image file annotation tool, an image file deletion tool, or one of
four user-definable external programs or .CMD files.
ΓòÉΓòÉΓòÉ 1.2. Legal Notices ΓòÉΓòÉΓòÉ
Licensed under U.S. Patent No. 4,558,302 and foreign counterparts.
This software is based in part on the work of the Independent JPEG Group.
The following terms are trademarks of the IBM Corporation in the United States
and/or other countries:
IBM
Operating System/2
OS/2
Presentation Manager
XGA
The following terms are trademarks of other corporations:
Aldus
Aldus is a registered trademark of Aldus Corporation.
Graphics Interchange Format
The Graphics Interchange Format is the copyright property of
CompuServe Incorporated.
GIF
GIF is a service mark property of CompuServe Incorporated.
Microsoft
Microsoft is a registered trademark of Microsoft Corporation.
TIFF
TIFF is a trademark of Aldus Corporation.
Windows
Windows is a trademark of Microsoft Corporation.
ΓòÉΓòÉΓòÉ 1.3. Command-Line Program Options ΓòÉΓòÉΓòÉ
The syntax for invoking PM I-Cat from an OS/2 command prompt window is:
>>ΓöÇΓöÇ IL ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
Γöé Γöé Γöé Γöé
Γö£ΓöÇΓöÇ directory name ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ ΓööΓöÇΓöÇ /F ΓöÇΓöÇΓöÿ
Γöé Γöé Γöé Γöé Γöé Γöé Γöé Γöé Γöé Γöé
Γö£ΓöÇΓöÇ list file name ΓöÇΓöÇΓöÇΓöÿ ΓööΓöÇΓöÇ /A ΓöÇΓöÇΓöÿ Γöé ΓööΓöÇΓöÇ /I ΓöÇΓöÇΓöÿ Γöé ΓööΓöÇΓöÇ /B ΓöÇΓöÇΓöÿ
Γöé Γöé Γöé
Γö£ΓöÇΓöÇ image file name ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ Γöé
Γöé Γöé
ΓööΓöÇΓöÇ slide group file name ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
ΓòÉΓòÉΓòÉ 1.3.1. List File Name ΓòÉΓòÉΓòÉ
The name of a file which contains a list of names of image files to be
processed. PM I-Cat will open and read this file at program startup and attempt
to generate a slide group from the image files that are named.
The image file names contained in the list file must comply with these
requirements:
o No more than one image file name appears on each line of text
o Each line of text ends with ASCII carriage-return and line-feed characters
o Image file names must conform with the file naming standards for the FAT or
HPFS formatted drive that they reside on
ΓòÉΓòÉΓòÉ 1.3.2. Directory Name ΓòÉΓòÉΓòÉ
The name of a disk directory that contains image files to be processed. PM
I-Cat will open and read the files in the specified directory at program
startup and attempt to generate a slide group from the image files found.
ΓòÉΓòÉΓòÉ 1.3.3. Image File Name ΓòÉΓòÉΓòÉ
The name of a image file to be processed. PM I-Cat will open and read the file
at program startup and attempt to generate a slide from the image file.
ΓòÉΓòÉΓòÉ 1.3.4. Slide Group File Name ΓòÉΓòÉΓòÉ
The name of a previously saved slide group file to be processed. PM I-Cat will
open and read the file at program startup and display the stored slide group.
ΓòÉΓòÉΓòÉ 1.3.5. /A (or /a) ΓòÉΓòÉΓòÉ
This argument causes PM I-Cat to process all file names found in the list file
or directory name specified. By default, PM I-Cat processes only image file
names.
This argument will be ignored if no list file name or directory name is
specified.
ΓòÉΓòÉΓòÉ 1.3.6. /I (or /i) ΓòÉΓòÉΓòÉ
This argument causes PM I-Cat to create a WorkPlace Shell folder file icon for
each image file specified in the list file or directory name specified, or for
the image file name specified.
This argument will be ignored if no list file name, directory name, or image
file name is specified.
ΓòÉΓòÉΓòÉ 1.3.7. /F (or /f) ΓòÉΓòÉΓòÉ
This argument causes the PM I-Cat program window to be maximized (i.e. become
full-screen) at program start-up.
ΓòÉΓòÉΓòÉ 1.3.8. /B (or /b) ΓòÉΓòÉΓòÉ
This argument causes the PM I-Cat browser tool to be invoked for the first
slide in the displayed slide group at program start-up.
This argument will be ignored if no list file name, directory name, image file
name, or slide group file name is specified.
ΓòÉΓòÉΓòÉ 1.4. Creating Large Composite Bitmaps ΓòÉΓòÉΓòÉ
If you select large numbers of image files to open, and/or if you specify large
thumbnail image sizes, you may be asking PM I-Cat to try to create a slide
group that is too large for your OS/2 system to handle. PM I-Cat can
theoretically create a slide group that is 32767 pixels wide and 32767 pixels
high, but most systems will be unable to create a slide group anywhere near
this large.
How big is the biggest slide group that you may create on your system? The
answer depends on several factors, including:
o The amount of memory installed in your machine
o The memory requirements of other applications running on your system
o The amount of disk space available for your system's SWAPPER.DAT swap file
o The version of OS/2 running on your system
If you attempt to create a slide group that is too large, you may see PM I-Cat
and/or OS/2 behave erratically. The program may display one or more error boxes
informing you that it has failed to create a "presentation space" or a bitmap,
and further processing will be aborted. OS/2 may display an error message
informing you that your SWAPPER.DAT swap file has grown too large for the disk
partition it is located in, and it will give you the option of terminating the
program.
If you suspect that a slide group that you wish to create will be too large for
your system, or if you experience error messages when you attempt the New
operation, there are several things you may do to remedy the situation. In
order of increasing difficulty, some of your options are:
o Reduce the number of files specified in the New dialog box. Consider creating
multiple slide groups, each containing a smaller number of slides.
o Select a smaller size for the thumbnail images. Thumbnail images may be as
small as 64 pixels by 64 pixels.
o Close some or all of the other applications running on your system,
especially those that are known to be memory hungry. Close any WINOS2 and DOS
sessions that may be running.
o Edit your CONFIG.SYS file to make OS/2 put the SWAPPER.DAT swap file on a
disk with more free space, then reboot your system.
o Install more memory in your machine.
Creation of larger slide groups, especially those that cause the OS/2 system to
have to swap data to disk or rearrange data in memory, may require an
unexpectedly long period of time to finish.
ΓòÉΓòÉΓòÉ 1.5. Getting Rid Of The Logo Window ΓòÉΓòÉΓòÉ
PM I-Cat consults your OS/2 system configuration parameters to determine how
long it should display its initial logo window. After you install OS/2, the
logo window display time is 'indefinite', and you must press ENTER to dismiss
the window. You may change the logo window display time to any desired value in
milliseconds, including 0, via the following procedure:
Under OS/2 PM's the Workplace Shell (WPS), open the "OS/2 System" folder on the
desktop. Under this folder, open the "System Setup" folder, and select the
"System" icon. The logo display time value can be changed via one of the
notebook 'tabs'.
ΓòÉΓòÉΓòÉ 1.6. Image File Type Abbreviations ΓòÉΓòÉΓòÉ
The labelling for each slide in the slide group may be tailored, via the Slide
options option under the Options action bar menu, to display only the
information that you wish to see. If you specify that the label is to include
file type information, the data is presented in the shorthand notation:
o BA - OS/2 Bitmap Array
o BM - OS/2 or Windows Bitmap Image
o CI - OS/2 Color Icon
o CP - OS/2 Color Pointer
o GIF - Graphics Interchange Format Image
o IC - OS/2 Black-and-White Icon
o PCX - PC Paintbrush Format Image
o PT - OS/2 Black-and-White Pointer
o TIFF - Tag Image File Format Image
o WCI - Windows Color Icon
o JFIF - JPEG File Interchange Format
ΓòÉΓòÉΓòÉ 1.6.1. BM ΓòÉΓòÉΓòÉ
BM indicates an OS/2 or Windows bitmap image file.
It is always followed by one of:
o PM 1.1 OS/2 PM 1.1
o PM 2.0 OS/2 PM 2.0
o WIN 3.0 Microsoft Windows 3.0
It may optionally be followed by:
o RLE4 Image is a 4-bit Run Length Encoded (RLE) file
o RLE8 Image is an 8-bit Run Length Encoded (RLE) file
ΓòÉΓòÉΓòÉ 1.6.2. IC ΓòÉΓòÉΓòÉ
IC indicates an OS/2 black-and-white icon file.
It is always followed by:
o PM 1.1 OS/2 PM 1.1
ΓòÉΓòÉΓòÉ 1.6.3. PT ΓòÉΓòÉΓòÉ
PT indicates an OS/2 black-and-white pointer file.
It is always followed by:
o PM 1.1 OS/2 PM 1.1
ΓòÉΓòÉΓòÉ 1.6.4. CI ΓòÉΓòÉΓòÉ
CI indicates an OS/2 color icon file.
It is always followed by one of:
o PM 1.2 OS/2 PM 1.2
o PM 2.0 OS/2 PM 2.0
ΓòÉΓòÉΓòÉ 1.6.5. WCI ΓòÉΓòÉΓòÉ
WCI indicates a Windows color icon file.
It is always followed by:
o WIN 3.0 Microsoft Windows 3.0
It may optionally be followed by:
o 1/M Displayed image is the first of several found in the file
ΓòÉΓòÉΓòÉ 1.6.6. CP ΓòÉΓòÉΓòÉ
CP indicates an OS/2 color pointer file.
It is always followed by one of:
o PM 1.2 OS/2 PM 1.2
o PM 2.0 OS/2 PM 2.0
ΓòÉΓòÉΓòÉ 1.6.7. BA ΓòÉΓòÉΓòÉ
BA indicates an OS/2 bitmap array file. This file type may contain one or more
OS/2 bitmap image, icon, or pointer files.
It is always followed by one of:
o (BM PM 1.1) OS/2 PM 1.1 bitmap
o (BM PM 2.0) OS/2 PM 2.0 bitmap
o (IC PM 1.1) OS/2 PM 1.1 b/w icon
o (PT PM 1.1) OS/2 PM 1.1 b/w pointer
o (CI PM 1.2) OS/2 PM 1.2 color icon
o (CP PM 1.2) OS/2 PM 1.2 color pointer
o (CI PM 2.0) OS/2 PM 2.0 color icon
o (CP PM 2.0) OS/2 PM 2.0 color pointer
It may optionally be followed by:
o 1/M Displayed image is the first of several found in the file
ΓòÉΓòÉΓòÉ 1.6.8. GIF ΓòÉΓòÉΓòÉ
GIF indicates a Graphics Interchange Format file, an image file format
developed and copyrighted by CompuServe, Inc.
It is always followed by one of:
o 87a Graphics Interchange Format version 87a
o 89a Graphics Interchange Format version 89a
It may optionally be followed by:
o I Interlaced image
o TC Displayed image uses a 'transparent' color
o (+ MacB) The file has a MacBinary I or II data header
ΓòÉΓòÉΓòÉ 1.6.9. PCX ΓòÉΓòÉΓòÉ
PCX indicates a PC Paintbrush format file, an image file format developed and
copyrighted by ZSoft Corp.
It is always followed by:
o Vn PCX file format version number (n)
o mB Number of bits (m) per color plane
o pPl Number of color planes (p) in the image
It may optionally be followed by:
o RLE Image is a Run Length Encoded (RLE) file
ΓòÉΓòÉΓòÉ 1.6.10. TIFF ΓòÉΓòÉΓòÉ
TIFF indicates a Tag Image File Format file, an image file format developed and
copyrighted by Aldus Corp. and Microsoft Corp.
It is always followed by one of:
o II Intel byte order
o MM Motorola byte order
Then follows:
o Tn TIFF image type (n), where
0 = bilevel or gray image, 0 = white
1 = bilevel or gray image, 0 = black
2 = RGB color image
3 = palette color image
4 = transparency mask
Then follows one of:
o CCITT G3 Image data is compressed via Modified Huffman RLE
o LZW Image data is compressed via LZW
o LZW+HD Image data is compressed via LZW with horizontal differencing
o PackBits Image data is compressed via PackBits
It may optionally be followed by one or more of:
o MS Image data is stored in multiple strips within the file
o 1/M Displayed image is the first of several found in the file
ΓòÉΓòÉΓòÉ 1.6.11. JFIF ΓòÉΓòÉΓòÉ
JFIF indicates a Joint Photographic Experts Group (JPEG) file interchange
format (JFIF), a format developed and popularized by the Independent JPEG
Group. PM I-Cat is based in part on the work of the Independent JPEG Group.
It is sometimes followed by:
o (Adobe) An Adobe APP14 marker was encountered
It is then always followed by one of:
o Gray Grayscale (monotone) image
o RGB Image utilizes the RGB color model
o YCbCrB Image utilizes the YCbCr (or YUV) color model
o YCCK Image utilizes the YCbCrK color model
o CMYK Image utilizes the CMYK color model
And it is then followed by one of:
o Arith Arithmetic entropy encoding
o Huff Huffman entropy encoding
ΓòÉΓòÉΓòÉ 2. Keys Help ΓòÉΓòÉΓòÉ
The list of keys is arranged in groups:
ACCELERATOR KEYS
Ctrl+N
Create a new slide group.
Ctrl+O
Read a slide group from a file.
Ctrl+S
Write the displayed slide group to a file.
Ctrl+P
Print the slide group.
Ctrl+I
Get information on the slide group being displayed.
F3
Exit program
HELP KEYS
F1
Get help
F2
Get general help (from within any help window)
Alt+F4
End help
F9
Go to a list of keys (from within any help window)
F11
Go to the help index (from within any help window)
Esc
Previous Help Panel, or End help if only one panel
Alt+F6
Go to/from help and programs
Shift+F10
Get help for help
ΓòÉΓòÉΓòÉ 3. Registration Information ΓòÉΓòÉΓòÉ
The following topics are available:
Definition of Shareware
Disclaimer of Warranty
License Agreement
How To Register Your Copy
ΓòÉΓòÉΓòÉ 3.1. Definition Of Shareware ΓòÉΓòÉΓòÉ
Shareware distribution gives users a chance to try software before buying it.
If you try a Shareware program and continue using it, you are expected to
register. Individual programs differ on details - some request registration
while others require it, some specify a maximum trial period. With
registration, you get anything from the simple right to continue using the
software to an updated program with printed manual.
Copyright laws apply to both Shareware and commercial software, and the
copyright holder retains all rights, with a few specific exceptions as stated
below. Shareware authors are accomplished programmers, just like commercial
authors, and the programs are of comparable quality. (In both cases, there are
good programs and bad ones!) The main difference is in the method of
distribution. The author specifically grants the right to copy and distribute
the software, either to all and sundry or to a specific group. For example,
some authors require written permission before a commercial disk vendor may
copy their Shareware.
Shareware is a distribution method, not a type of software. You should find
software that suits your needs and pocketbook, whether it's commercial or
Shareware. The Shareware system makes fitting your needs easier, because you
can try before you buy. And because the overhead is low, prices are low also.
Shareware has the ultimate money-back guarantee - if you don't use the product,
you don't pay for it.
ΓòÉΓòÉΓòÉ 3.2. Disclaimer of Warranty ΓòÉΓòÉΓòÉ
Users of PM I-Cat must accept this disclaimer of warranty: PM I-Cat IS SOLD AS
IS. BINK ENTERPRISES DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED,
INCLUDING, WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS
FOR ANY PURPOSE. BINK ENTERPRISES ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR
CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF PM I-Cat.
ΓòÉΓòÉΓòÉ 3.3. License Agreement ΓòÉΓòÉΓòÉ
PM I-Cat is a "shareware program" and is provided at no charge to the user for
evaluation. Feel free to share it with your friends, but please do not give it
away altered or as part of another system. The essence of "user-supported"
software is to provide personal computer users with quality software without
high prices, and yet to provide incentive for programmers to continue to
develop new products.
If you find this program useful and find that you are using PM I-Cat and
continue to use PM I-Cat after a reasonable trial period of 30 days, you must
make a registration payment of $24.95 (U.S. Dollars), plus $4.00 (U.S. Dollars)
for shipping and handling to BinK Enterprises. The registration fee will
license one copy for use on any one computer at any one time. You must treat
this software just like a book. An example is that this software may be used
by any number of people and may be freely moved from one computer location to
another, so long as there is no possibility of it being used at one location
while it's being used at another. Just as a book cannot be read by two
different persons at the same time.
Commercial users of PM I-Cat must register and pay for their copies of PM I-Cat
within 30 days of first use or their license is withdrawn. Site-License
arrangements may be made by contacting BinK Enterprises.
Anyone distributing PM I-Cat for any kind of remuneration must first contact
BinK Enterprises for authorization. This authorization will be automatically
granted to distributors recognized by the Association of Shareware
Professionals (ASP) as adhering to its guidelines for shareware distributors,
and such distributors may begin offering PM I-Cat immediately (however, BinK
Enterprises must still be advised so that the distributor can be kept
up-to-date with the latest version of PM I-Cat).
You are encouraged to pass a copy of PM I-Cat along to your friends for
evaluation. Please encourage them to register their copy if they find that
they can use it. All registered users will receive a copy of the latest
version of the PM I-Cat program.
ΓòÉΓòÉΓòÉ 3.4. How To Register Your Copy ΓòÉΓòÉΓòÉ
You may register your copy of PM I-Cat by BinK Enterprises for only $24.95
(U.S. Dollars), plus $4.00 (U.S. Dollars) for shipping and handling.
In return for your payment, you will receive a certificate of registration in
your name and a copy of the latest version of the program on one 1.44MB 3.5"
diskette.
FOR CREDIT CARD ORDERS ONLY:
You can order with MC, Visa, Amex, or Discover from:
Public (software) Library
Voice 800-2424-PsL or 713-524-6394
FAX 713-524-6398
CIS Email to 71355,470
You can also mail credit card orders to:
PsL
P.O. Box 35705
Houston, TX 77235-5705
To ensure that you get the latest version, PsL will notify us the day of your
order, and we will ship the product directly to you.
THE ABOVE NUMBERS ARE FOR CREDIT CARD ORDERS ONLY. THE AUTHOR OF THIS PROGRAM
CANNOT BE REACHED AT THESE NUMBERS.
FOR QUESTIONS AND NON-CREDIT CARD ORDERS:
Any questions about the status of the shipment of the order, refunds,
(.txt)